<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="color-scheme" content="light dark" />
    <title>Design Tokens Resolver Module 2025.10</title>
    <script
      src="https://www.w3.org/Tools/respec/respec-w3c"
      class="remove"
      defer
    ></script>
    <script class="remove">
      const respecConfig = {
        specStatus: 'CG-DRAFT',
        isPreview: true,
        group: 'design-tokens',
        latestVersion: 'https://www.designtokens.org/TR/2025.10/resolver/',
        prevVersion: null,
        edDraftURI: null, // MUST be null for community group
        editors: [
          { name: 'Joren Broekema', url: 'https://code-workshop-kit.com/' },
          { name: 'Esther Cheran', url: 'https://github.com/esthercheran' },
          { name: 'Mike Kamminga', url: 'https://hyma.io' },
          { name: 'Andrew L’Homme' },
          { name: 'Drew Powers', url: 'https://pow.rs' },
          { name: 'Matthew Ström-Awn', url: 'https://matthewstrom.com' },
          { name: 'Lilith Wittmann', url: 'https://github.com/LilithWittmann' },
        ],
        authors: [
          { name: 'Louis Chenais', url: 'https://bsky.app/profile/lucho.cool' },
          { name: 'James Nash', url: 'https://cirrus.twiddles.com' },
        ],
        github: {
          repoURL: 'https://github.com/design-tokens/community-group',
          branch: 'main',
        },
        tocIntroductory: true,
        logos: [
          {
            src: '/assets/dtcg-logo-on-color.svg',
            url: 'https://www.designtokens.org',
            alt: 'Design Tokens Community Group',
            width: 128,
            height: 128,
            id: 'dtcg-logo',
          },
        ],
      };
    </script>
  </head>
  <body>
    <section id="abstract">
      <p>
        This specification extends the <a href="../format/">format</a> and
        describes a method to work with <a href="../">design tokens</a> in
        multiple contexts (such as “light mode” and “dark mode” color themes).
      </p>
    </section>

    <section id="sotd">
      <p>
        This section describes the status of this document at the time of its
        publication. Other documents may supersede this document. A list of
        current W3C Community Group reports and the latest revision of this
        report can be found in the W3C Community Group reports index at
        <a href="https://www.w3.org/community/reports/"
          >https://www.w3.org/community/reports/</a
        >.
      </p>
      <p>
        ⚠️ This is a <strong>preview draft</strong> of in progress changes. Do
        not refer to this document directly, and do not implement anything in
        this document.
      </p>
    </section>

    <section
      id="introduction"
      class="informative"
      data-include="./introduction.md"
      data-include-format="markdown"
    ></section>

    <section
      id="terminology"
      data-include="./terminology.md"
      data-include-format="markdown"
    ></section>

    <section
      id="filetype"
      data-include="./filetype.md"
      data-include-format="markdown"
    ></section>

    <section
      id="syntax"
      data-include="./syntax.md"
      data-include-format="markdown"
    ></section>

    <section
      id="inputs"
      data-include="./inputs.md"
      data-include-format="markdown"
    ></section>

    <section
      id="resolution-logic"
      data-include="./resolution-logic.md"
      data-include-format="markdown"
    ></section>

    <section
      class="informative"
      id="bundling"
      data-include="./bundling.md"
      data-include-format="markdown"
    ></section>

    <section
      id="conformance"
      data-include="./conformance.md"
      data-include-format="markdown"
    ></section>

    <section id="acknowledgements" class="appendix informative">
      <h2>Acknowledgments</h2>
      <p>
        This resolver spec wouldn’t have happened without the Hyma Team,
        including but not limited to Mike Kamminga, Andrew L’Homme, and Lilith.
        Significant contributions were also made by Joren Broekema, Louis
        Chenais. We thank the members of the Design Tokens Community Group for
        their contributions and feedback.
      </p>
    </section>
  </body>
</html>
